Acronym Manager 2.2

Date:		August 11, 2006
Description:	Acronym Manager is a simple and easy-to-use acronym replacing addon.
Features:	1) Add, edit, delete and preview acronyms.
		2) Enable or disable acronyms.
		3) Strip control codes and/or restrict acronym usage in all/only-allowed/non-disallowed/+c channels.
		4) Acronym tab completion in editboxes for channels, queries, dcc chat windows and fserve windows

By:		Relinsquish
IRC:		irc.scrollrack.com @ #scripting
E-mail:		Relinsquish@gmail.com

::Attached Files::

acros readme.txt (readme)
acros.hsh (preset acronyms)
acros.mrc (script file)
dcx.dll (dll)

::Install::

1) Type //load -rs $sfile($mircdir) in mIRC and open acros.mrc
   or
   Press Alt+R, then Ctrl+L in mIRC and open acros.mrc
2) If an error message is shown in the active window once you load the script, follow the shown instructions, then reload the script.
3) In your mIRC, type /acros to open the Acronym Manager.

::Syntax::

/acros opens up the dialog acros
/acros <on|off> enables or disables acronyms
/acros -a <acronym> <long form> adds an acronym to the list
/acros -c clears the acronym list
/acros -r <acronym> removes an acronym from the list

$acros returns on or off depending on if the acronyms are enabled or disabled
$acros(acronym) returns the long form of the acronym
$acros(long form,N).acro returns the Nth acronym of the long form

/acrostab [on|off] enables or disables acronym tab completion
$acrostab returns on or off depending on if acronym tab completion is enabled or disabled

::Examples::

In channel #mIRC.net:

"lolipop lol 123[ENTER]" will send the message "lolipop laughing out loud 123"

"lolipop l[TAB]ol 123" will replace the editbox text with "lolipop laughing out loud[CURSOR HERE] 123"

::Note::

Acronym tab completion will mess up the spaces by replacing multiple spaces with 1 space and removing beginning spaces. (mIRC limitation)

Also, acronym tab completion does not follow the acronym channel exclusion settings.
This means that that acronym tab completion will work in all channels.
However, it DOES follow the control code settings.
Therefore, sometimes the replaced text might be stripped of control codes.

::Version History::

Version 2.2

- Fixed bug where acronyms did not work when you initially load the script and don't open the channel exclusions dialog
- Added [-a/-c/-r] switches to /acros
- /acros and /acrostab both echo information messages unless you silence them using .acros and .acrostab (/acros with no switches shows no message regardless of silencer)


Version 2.1

** Added acronym tab completion to allow users to press tab on the acronyms in editboxes to replace them with their long form
   (uses mIRC 6.2's awesome on TABCOMP =D)

- Requires mIRC 6.2 or higher now
- Added /acrostab [on|off] command to enable or disable acronym tab completion
- Added $acrostab identifier to return the status of acronym tab completion (on or off)
- Now closes preview window when unloading the script
- Added /acros [on|off] command to enable or disable acronyms
- Added error checking to see if entered channel is only 1 word
- Reworded "colours" to "control codes" since +c also deals with bolds, underlines and reverses
- Fixed listview selection bug

Version 2.0

- Completely recoded the whole script; more efficient, cleaner code
- Switched from MDX to DCX
- Added channel exclusion feature to strip colours and/or restrict acronym usage in all/only-allowed/non-disallowed/+c channels
- Added preview acronym feature to allow users to see how the long forms of the acronyms would look like (helpful especially if it contains colour)

Version 1.1

- Now has columns to seperate Short Form and Acronym
- Changed from using variables to hash tables so when saying mathematical equations eg. 123 - 123, it will return 123 - 123 instead of returning 0

Version 1.0

- First release of Acronym Manager
- Now supports colours

::Requirements::

mIRC 6.2 or higher
DCX DLL 1.3.1 or higher

::Bug::

- You will HAVE to put a closing control code after every "long form" if a bold, underline, reverse or colour control code is used because this addon doesn't close it for you automatically if you want it to change back to the normal style

::Credits::

mIRC - Khaled Mardem-Bey
DCX (Dialog Control Xtension) - ClickHeRe

::Scripter's Note::

If you would like to modify my script in any way, please feel free to do so. If it is possible, I would like credit for my work although it is not necessary.